SGSetChannelPlayFlags(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Working With Channel Characteristics

SGSetChannelPlayFlags
The SGSetChannelPlayFlags function allows you to influence the speed and quality with which the sequence grabber displays data from a channel.
pascal ComponentResult SGSetChannelPlayFlags (SGChannel c, 
                                              long playFlags);
c
Specifies the reference that identifies the channel for this operation. You obtain this reference from the SGNewChannel function, described on page 5-29.
playFlags
Specifies a long integer that contains flags that influence channel playback. The following values are defined--you must use one of these values:
channelPlayNormal
Instructs the channel component to use its default playback methodology.
channelPlayFast
Instructs the channel component to sacrifice playback quality in order to achieve the specified playback rate.
channelPlayHighQuality

Instructs the channel component to play the channel's data at the highest possible quality--this option sacrifices playback rate for the sake of image quality. This option may reduce the amount of processor time available for recording. This option does not affect the quality of
the recorded data, however.

The following flag is defined--you may use this flag with any of the values defined for this parameter (set unused flags to 0):
channelPlayAllData
Instructs the channel component to try to play all of the data it captures, even the data that is stored in offscreen buffers. This option is useful when you want to be sure that the user sees as much of the captured data as possible. Set this flag to 1 to play all the captured data. You may combine this flag with any of the values defined for the playFlags parameter.

DESCRIPTION
The SGSetChannelPlayFlags function does not affect the quality of a record operation.

SPECIAL CONSIDERATIONS
You cannot call this function during a record operation; you can call it during a preview operation.